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The Meshastic project, founded in early 2020, uses 
inexpensive LoRa radios to create an off-grid mesh network 
for communication. If you've ever been hiking or camping in 
the wilderness away from cell towers, or at locations like 
music festivals where infrastructure is often congested from 
a high volume of use, you may understand the need for a 
platform that doesn't rely on traditional communication 
services. 


Meshtastic is completely off-grid, and doesn't rely on any 
existing networks or infrastructure. It does so using LoRa 
(short for Long Range) radios that are advertised as being 
able to transmit data at a typical range of 10km (~6 miles) in 
areas with a clear line of sight, and some have reported 
communicating over longer distances. In a city environment 
with many obstructions, your range is more likely to be 1-3 
blocks. 


LoRa implements chirp spread spectrum (CSS) modulation, 
meaning that it is robust to channel noise and resistant to 
multi-path fading, resulting in low interference. 


It is important to note that LoRa is not designed for 
high-speed data transmission, and the hardware is only 
capable of transmitting between 250 bits/s and 27 kbits/s. At 
this speed, LoRa is ideal for text communication via realtime 
chat as well as location beaconing, though it has also been 
adopted for use in loT and sensor networks. 


Meshtastic uses LoRa technology to provide a 
communication platform ideal for small groups of people 
who wish to have private conversations. This can be ideal for 
a temporary setup where there is no traditional 
infrastructure to use, or a permanent setup with fixed and 
mobile nodes operating in a particular neighborhood. 


BUILDING A MESH 


Each node in a Meshastic network is composed of a LoRa 
radio device, typically paired via Bluetooth to a mobile 
phone. Once paired, the host device can run the Meshtastic 
application to send and receive messages on the network. 


Each node in the Meshtastic network additionally acts as a 
relay for other nodes. For example, if Alice and Bob want to 
send messages to one another, but are physically too far 
apart to make a connection, their data can automatically be 
routed through a third user, Carlos, who is physically 
between and in range of both Alice and Bob. This means 


that even the most distant nodes on the network have the 
ability to communicate with all other nodes, even if they are 
not nearby. As long as Alice and Bob are using a private 
encryption key, Carlos won't be able to read their messages. 
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Nodes can also be set up as standalone repeaters that 
simply route traffic through the network without being 
connected to a host device. This allows nodes to be 
operated in an isolated or otherwise fixed position, 
supplying connection to the greater network for others 
nearby. This can be an ideal configuration for solar-powered 
nodes that are elevated for line-of-sight connection, 
requiring little to no maintenance from the operator. 


PRIVACY 


By default, a new Meshtastic node is configured to use a 
general chat channel that everyone has access to. That 


makes it easy to get started, but it means your messages 
can be read by any other Meshtastic user. 


To keep your messages secure, you can create a new 
channel using a custom AES-256 encryption key. As long as 
you and your friends keep the key private (which means not 
posting it online), no one else will be able to decipher your 
chat. 


If you want, Meshtastic can share your current GPS 
coordinates with everyone else on the channel you're using. 
Sharing your location can be helpful if you're in a remote 
area or navigating a large crowd. If you're using Meshtastic 
from home, we recommend turning off GPS sharing. 


SUPPLIES 


Setting up a Meshtastic node is relatively inexpensive, 
assuming you already have a computer you can use to 
interact with the radio. You may want to get materials for 
two nodes so you can test an end-to-end connection. 


Currently, there are Meshtastic applications for both 
Android and iOS, though the iOS application is in beta. 
Alternatively, there is a Meshtastic-python library you can 
use to interface with a LoRa radio via PC, but you will likely 
need some prior Python language experience to make full 
use of it. Further, there is a serial interface and web 
interfaces to access Methtastic from a browser, though the 
latter may currently be unstable. There is no current turnkey 
application for PC use. 


When you purchase your board, make sure to get one that 
operates in a frequency you are allowed to transmit on in 
the country you are operating in. In the United States we're 
using 915MHz. 


HELTEC LORA32 SETUP 


Your LoRa radio comes with an antenna, which you'll want 
to connect before going further. If you power on your LoRa 


radio without an antenna attached, you may damage the 
circuitry. 


If you're using a Heltec LoRa32, your antenna uses an IPEX-1 
connector. The port you'll connect it to is on the front of the 
device, to the right of the LCD screen. 


(J Line up your antenna's IPEX-1 connector with the port 
side on your LoRa32 and press it on with your thumb. It may 
take more pressure than you expect. 


INSTALL PYTHON AND PIP 


Before you flash the Meshtastic firmware to your LoRa 
device you'll need Python 3 and the pip package manager. 
To check whether you have them, first open a terminal 
window. (If you're using macOS, open the Terminal app. In 
Windows you can use PowerShell.) 
LJ Type the following command and press enter: 
python3 -m pip -V 
If Python 3 and pip are installed, you'll see a version number 
for both. If you get an error message, you'll need to install 
them. 
Install Python 3 with pip on 
Debian-based Linux 
(J Open a terminal window and run the following 


commands to install Python 3 and the pip package 
manager: 


sudo apt-get update 
sudo apt-get install python3 
sudo apt-get install python3-pip 


python3 -m pip install -U pip 


| If Python and pip are already installed, you can run the 
following command to update them: 


sudo apt-get update 
sudo apt-get upgrade 
python3 -m pip install --upgrade pip 


Install Python 3 with pip on macOS 


“I Go to this page and follow the instructions to install 
Python 3 on macOS: 


https://docs.python-guide.org/starting/install3/osx 


4) Once Python is installed, run this command to upgrade 
the pip package manager: 


python3 -m pip install --upgrade pip 


Install Python 3 with pip on Windows 


[1 You may want to install Git Bash, which will let you run 
Linux-like commands instead of using PowerShell. (This is 
optional.) Here's the download page: 


https://git-scm.com/downloads 


LI Go to the following URL and follow the instructions to 
install Python 3 on Windows: 


https://realpython.com/installing-python/#how-to-install-pyt 
hon-on-windows 


4 Once Python is installed, run this command to upgrade 
the pip package manager: 


python3 -m pip install --upgrade pip 


INSTALL ESPTOOL 


(4) Next you'll run the following command in a terminal 
window to install the esptool Python package. The same 
command should work for Linux, macOS, and Windows. 


python3 -m pip install --upgrade esptool 


INSTALL HELTEC LORA32 DRIVER 
1 Go to the following URL and download the Arduino IDE: 
https: //arduino.cc/en/software 


Follow the following page and follow the instructions 
under Use Arduino Library Manager: 


https: ithub.com/HeLTecAutomation/Heltec ESP32 


INSTALL USB SERIAL DRIVER 
(WINDOWS ONLY) 


(J Go to the following URL: 


https: //www.silabs.com/deveLopers/usb-to-vart-bridge- 
vep-drivers?tab=downloads 


4) Click CP210x Windows Drivers to download a .zip file 
containing the driver. 


(J) Extract the .zip file you just downloaded and install the 
driver. 


FLASH MESHTASTIC FIRMWARE 
TO LORA RADIO 
“I Go to the following URL to find the latest Meshtastic 
firmware releases: 


https://github.com/meshtastic/firmware/releases 


4 Scroll down until you find the latest release with Beta in 
the title. In the image below, it's Meshtastic Firmware 
2.1.5.23272da Beta. Click on the title of the release. 


Jun 3 
github-actions 


© v2.1.15.cd787... 
© cd78723@ 


Compare ~ 


Meshtastic Firmware 2.1.15.cd78723 Beta 


Enhancements 


* Wio-e5 support progress by @thebentern in #2265 

* Open up Serial Module to T-Echo by @thebentern in #2533 

* Enable range test module (sending only) on NRF by @thebentern in #2534 
* Use INA for device battery level by @thebentern in #2536 


Bug fixes 


* Cancel rebroadcast in Tx queue upon receiving another rebroadcast by @GUVWAF in 
#2538 


Full Changelog: v2.1.14.99a31c1...v2.1.15.cd78723 


Contributors 


QO& 


thebentern and GUVWAF 


[4 Scroll down and look for a link to a .zip file with 
"firmware" at the beginning of the filename 
(firmware-2.1.5.23272da.zip in the example below). Click 
the filename to download the firmware release. 


e ©) Release Meshtastic Firmwa x + 


[G} 06 = github.com 110% 


vy Assets 4 


Q@debug-elfs-2.1.5.23272da.zip 
414 MB 


@firmware-2.1.5.23272da.zip 
54.8 MB 


ff) Source code (zip) 


[f) Source code (tar.gz) 


« 1 1 person reacted 


https://github.com/meshtastic/firmware/releases/...nload/v2.1.5.23272da/firmware-2.1.5.23272da.zip 


C Find the .zip file you just downloaded. Right-click it and 
extract to the current directory. 


Downloads 


File Edit View Go Bookmarks Help 
<¢ > * 4) && iffybooks 4 Downloads 


My Computer Name Size Type 


Home © firmware-2.1.5.23272da Oitems Folder 
MB Desktop @ firmware-2.1.5.23272dazip 57.4MB Archive 


BB Documents 
Ja Music 


Q Pictures 


videos 


4 Downloads 


2 items, Free space: 7.9 GB 


J Open a terminal window and type cd followed by a space. 
Click on the firmware directory you just created and drag it 
onto the terminal window. 


if fybooks@Iffy-Books:~$ cd | 


The directory's full pathname will appear in the terminal 
window. Press enter to change your working directory to 
the new firmware directory. 


iffybooks@IFfy-Books: ~ -o@€ 
n Terminal Hel 


eee eeee eer mem | /home/iffybooks/Downloads/firmwar 


e-2.1.5.23272da" 


(I Type Ls and press enter to see a list of files in the 
current directory. 


LI Type the following command in the terminal window, 
followed by a space. (Windows PowerShell users should type 
./device-install. bat instead.) 


./device-install.sh -f 


h 


File Edit View cone) ute 
if fybooks@If fy-Books :~/Downloads/firmware-2.1.5.23272da$ ./device-install.sh -f Jf 


[J Open the firmware directory in your File Explorer/Finder 
and find the file that starts with firmware-heltec-v3 and 
ends with .bin. The filename below is 
firmware-heltec-v3-2.1.5.23272da.bin. 


firmware-2.1.5.23272da 0@ 
File Edit View Go Bookmarks Help 
€ > 4 $ Downloads | firmware-2.1.5.23272da > “ ss [iS] 2: 
~ My Computer Name i Type 
ff Home _ firmware-heltec-v2.0-2.1.5.23272da-update.bin Binary 
Ml Desktop Firmware-heltec-v2.1-2.1.5.23272da.bin Text 
Ih Documents Firmware-heltec-v2.1-2.1.5.23272da-update.bin Binary 
Jl Music IB firmware-heltec-v3-2.1.5.23272da.bin 
1 Pictures Firmware-heltec-v3-2.1.5.23272da-update.bin 1.9MB Binary 
Hi Videos Firmware-heltec-wsl-v3-2.1.5.23272da.bin 1.9MB_ Binary 
$ Downloads Firmware-heltec-wsl-v3-2.1.5.23272da-update.bin 1.8MB_ Binary 
(5) File system Firmware-m5stack-core-2.1.5.23272da.bin 2.0MB Text 
Bi trash firmware-m5stack-core-2.1.5.23272da-update.bin 2.0MB_ Binary 
(insane firmware-m5stack-coreink-2.1.5.23272da.bin 2.1MB_ Text 


f a "Firmware-heltec-v3-2.1.5.23272da.bin” selected (1.9 MB), Free space: 7.9 GB _ 


(I Drag the file into your terminal window to add the path to 
your command. 


iffybooks@IFfy-Books: ~/Downlo: 


iffybooks@lff ooks :~/Downloads/firmware-2.1.5.23272da$ ./device-install.sh -f Wiehe 
iffybooks/Downloads/firmware-2.1.5.23272da/firmware-heltec-v3-2.1.5.23272da.bin' 


Here's the full command in the example above: 


./device-install.sh -f 
'/home/iffybooks/Downloads/firmware-2.1.5.2327 
2da/firmware-heltec-v3-2.1.5.23272da.bin' 


1 Press enter to run the command and start flashing your 
LoRa radio. It may take several minutes to finish. 


4 If you're using Linux, you may need to add sudo before 
the command above. 
4 If something goes wrong, refer to the "Flashing with the 
CLI" page on the Meshtastic website: 

https://meshtastic.org/ /getting-started/flashing-firm 

ware/esp32/cli-script 

li Connect a USB-C cable to your LoRa radio and plug the 
other end into a USB power source, such as a computer. 


You'll see the Meshtastic logo on the LCD screen, followed 
by a screen that looks like this: 


At the top right of the screen you'll see a 4-digit ID code that 
identifies your device. In this case the device's ID is b494. 


INSTALL THE MESHTASTIC APP ON YOUR 
PHONE 


iOS: Search for "Meshtastic" in the App Store and install it. 


Android: Download the .apk from GitHub and sideload it: 
https://github.com/meshtastic/Meshtastic-Android/ 


If you you use the F-droid app store, follow the instructions 
on this page: 


https://meshtastic.org/docs/software/android/installation 


Or go to the Google Play Store and search for "Meshtastic." 


PAIR WITH YOUR LORA RADIO 
(ANDROID) 


[J Open the Meshtastic app and tap the plus sign (+) in the 
bottom right corner to start scanning for LoRa devices. 


Anonymous usage Statistics 
and crash reports. REPORT BUG 


Q) Find your device using its four-character ID. Tap the radio 
button next to it to start pairing. 


//\. Meshtastic 


You have not paired a radio yet 


© None (disable) 
O Meshtastic_6ddc 


You h paired a Meshtastic compatible radio 
with tl ». Please pair a device and set your 
usernar, 


This open-source ¢ ation is in development, 
if you find problems p post on our forum: 
meshtastic.discourse.gruup 


4 Your LoRa device will display a six-digit code on its screen. 
Enter the code in the app, then tap OK. 


Pair with Meshtastic_6ddc? 


Usually 0000 or 1234 


Oo PIN contains letters or symbols 


You may also need to type this PIN on the 
other device. 


PAIR WITH YOUR LORA RADIO (iOS) 


(J Tap the Bluetooth icon at the bottom of the screen. Find 
your LoRa device under Available Radios and tap it. 


/\N™ 
Bluetooth 


Connected Radio 


@ Encryption is insufficient. Please try 
connecting again and check the PIN 
carefully. 


(\) No device 
| connected 


Available Radios 


* Meshtastic_57e4 


«p) 


Bluetooth 


Q Your LoRa device will display a six-digit code on its screen 
Enter the code in the app, then tap Pair. 


Bl 1iatanth 


Bluetooth Pairing Request 
Cc "Meshtastic_57e4” would like to 
pair with your iPhone. Enter the 
code shown on 
“Meshtastic_57e4". Do not do 
anything on “Meshtastic_57e4" 
( until pairing is complete. 


Cancel 


SET YOUR REGION (ANDROID) 


() Tap Region at the top right of your screen. (It’s in tiny 
gray type with a triangle underneath.) 


//\. Meshtastic 


Your Name 


Region 
Meshtastic 6ddc UNSET v 


You must set a region! 


O None (disable) 


© Meshtastic_6dde 


(_] Provide location to mesh 


Q) Select your region from the dropdown menu. 


//\. Meshtastic 


Your Name Region 


Meshtastic 6ddc ¥ 


You must set a region! 


O None (disable) 
© Meshtastic_6dde LORA_24 


(-] Provide location to mesh NZ_865 
RU 
TH 
TW 
UA_433 
UA_868 + 
UNSET 


Anonymous usage 
oO statistics and crash aac uc 
reports. 


(J Tap Save, which will reboot your LoRa device. 


SET YOUR REGION (iOS) 
“J Tap the Bluetooth icon. 


«p) — 


Bluetooth 


“1 Tap Set LoRa Region. 


VX 
Bluetooth 


Connected Radio 


Meshtastic 57e4 


BLE? 


7e4 
Firmware Version: 2.1.5 


Subscribed to mesh 


® Set LoRa Region 


“I Tap Please set a region and select your region from the 
dropdown menu. 


< Bluetooth 57e4 < Bluetooth @) 57e4 


LoRa Config LoRa Config 


Configuration for: Config 


Meshtastic 57e4 Mesht; Please set a region 


V United States 
OPTIONS 
European 
Region Please set a region © Union 433mhz 


European 
Union 868mhz 


The region where you will be using your radios. 


Use Preset T @) 


Presets Long Range - Fast © Presets 
Japan 


China 


Available modem presets, default is Long Fast. Available | - 
Australia / New Zealand 


“1 Tap Save, which will reboot your LoRa device. 


((p) 


Bluetooth 


NAME YOUR LORA RADIO (ANDROID) 


(4) Tap the three dots at the top right corner of the screen 
and select Radio configuration. Then tap User. 


Radio configuration 


— ~.., 
Channels 


Device 


Position 


(4) Enter a short name (<=4 characters) and long name for 
your LoRa radio. 
User Config 


Node ID 
'fa666ddc 


Long name 


Iffy Books 


Short name 


IEEY. 


Hardware model 
HELTEC_V3 


Licensed amateur radio 


(J Tap Send to save and reboot. 


NAME YOUR LORA RADIO (iOS) 
“1 Go to Settings in the Meshtastic app, then tap User. 


( Enter a short name for your device (<= 4 characters). You 
have to change the short name first, for unknown reasons. 


“J Tap Save, which will reboot your device. 


“J Go to the Settings, then tap User. Enter a long name for 
your device. 


“J Tap Save, which will reboot your device. 
< Settings | User Config @ < 

USER DETAILS 

&§ Long Name Steve 


Long Name can be up to 36 bytes long. 


@ Short Name sri 


The last 4 of the device MAC address will be 
appended to the short name to set the device's 
BLE Name. Short name can be up to 4 bytes long. 


Licensed Operator 


(4 Save 


UPDATE LORA RADIO SETTINGS 


The screen captures below are from the iOS app, but the 
steps are the same for Android. 


LJ In the iOS Meshtastic app, open Settings. In the Android 
app, tap the three dots at the top right corner of the screen 
and select Radio configuration. 


(p) — 


Bluetooth 


“(OS only: Under Configure in the Settings menu, make 
sure your LoRa device is selected. If it isn't, select it from the 
dropdown menu. 


(J Tap LoRa to open the LoRa radio settings. 


Settings 
About Meshtastic 


&} App Settings 


82 Share Channels QR Code 
@ User 


(™) LoRa 


= Channels 


Meshtastic has eight built-in presets for the way it transmits 
data, which are called modem presets. The modem preset 


you choose will determine the maximum distance you'll be 
able to transmit and receive, as well as how long it takes to 
send each message. 


It's important to note that you and your friends will need to 
use the same modem preset. If you're using different 
presets, you won't be able to see each other's messages at 
all. 


1) The default modem preset is called Long Range / Fast. 
Tap the dropdown menu next to Presets to see the other 
options. For now, leave Long Range / Fast selected. 


< Settings LoRa Config 


Configuration for: 
Meshtastic cb88 


OPTIONS 
Region United States © 


The region where you will be using your radios. 


Use Preset T @ 


Presets Long Range - Fast © 


Available modem presets, default is Long Fast. 


Here's a table with details on all eight of Meshtastic’s 
modem presets: 


Channel Alt Channel SF/ Coding Link 
Fast 
se ’! Short Slow | 3.9kbps | 8/256 140dB 


rast o me ie re 
Medium Range! wedium slow| 1.2kbps |10/1024| 4/8 250 146dB 
/ Slow 
Long Range / 0.67 kbps 
Long Range / Long 
0.335 kbps } 11/2048] 4/8 125 151dB 
Bal Hae Long Slow | 0.18kbps | 12/4096 154dB 
VeryLong | Verylon8 | oogkbps | 12/4096] 4/8 62.5 157dB 
Range / Slow Slow 


Source (with details on terms & abbreviations in the table 
above): https://meshtastic. org/docs/overview/radio-settings 


(4 Scroll down in the LoRa settings and you'll see an option 
called Number of hops. By default, each message you send 
will make three hops across the mesh network before nodes 
stop retransmitting it. Increasing the number of hops risks 
overloading the network, so you should leave it on 3 unless 
you have a good reason to change it. 


ADVANCED 


4" Transmit Enabled T @ 


Number of hops 3¢ 


Sets the maximum number of hops, default is 3. 
Increasing hops also increases air time 
utilization and should be used carefully. 


[I Keep scrolling down and you'll see the RX Boosted Gain 
option, which makes your LoRa radio more sensitive to weak 
signals. If you're near other LoRa devices, leave it unchecked 
for now. 


If you're trying to connect to a Meshtastic network from a 
distance (especially in a dense urban area), you can turn this 
option on. Then tap Save, which will reboot your device. 


This determines the actual frequency you are 
transmitting on in the band. 


‘lly ~RX Boosted Gain T @) 


(4 Save 


Settings 


SET YOUR DEVICE ROLE 


The screen captures below are from iOS, but the steps are 
the same for Android. 


“1 In the iOS Meshtastic app, go to Settings. In the Android 
app, tap the three dots in the top right corner and go to 
Radio Configuration. 


“I Tap Device. 


Meshtastic has seven device configuration presets (a.k.a. 
device roles), which you can change depending on how you 
plan to use your Meshtastic node. 


Tap the drop down menu next to Device Role to see the 
options. The default device role is called Client. 


< Settings DeviceConfig 


Configuration for: 
Meshtastic 6ddc 


OPTIONS 


Device Role 
Client (a ¥ Client 
Muted Client 
Rebrog 
Router 
Router & Client 
Repeater 


Tracker 


Sensor 


Here's a table with details on each device role: 


Device Configuration 
Preset Description 
(a.k.a. Device Role) 


CLIENT Client (default) - This role will follow the standard 
routing rules while also allowing the device to 
interact with client applications via BLE/Wi-Fi 
(Android/Apple/Web). 


CLIENT_MUTE Client Mute - Same as a client except packets will 
not hop over this node, does not contribute to 
routing packets for mesh. 


ROUTER Router - Mesh packets will prefer to be routed over 
this node. The assumption is that Router-type 
devices will be placed in locations with a 
height/range/antenna advantage, and therefore 
have better overall coverage. This node will not be 
used by client apps. The BLE/Wi-Fi radios and the 
OLED screen will be put to sleep. Please note: Due 
to the preferred routing, this role may cause higher 
power usage due to more frequent transmission. 


ROUTER_CLIENT Router Client - Hybrid of the Client and Router 
roles. Similar to Router, except the Router Client 
can be used as both a Router and an app 
connected Client. BLE/Wi-Fi and OLED screen will 
not be put to sleep. 


REPEATER Repeater - Mesh packets will prefer to be routed 
over this node. This role eliminates unnecessary 
overhead such as Nodelnfo, DeviceTelemetry, and 
any other mesh packet, resulting in the device not 
appearing as part of the network. As such, direct 
messaging this node is not available, as it will not 
appear in your nodes list which results in a cleaner 
mesh network. Channel and modem settings of the 
mesh packets being repeated must be identical to 
the repeater's configuration. Please see 


Rebroadcast Mode for additional settings specific 
to this role. 


TRACKER Tracker - For use with devices intended as a GPS 
tracker. Position packets sent from this device will 
be higher priority. Smart Position Broadcast will 


default to the currently configured settings. 


Sensor - For use with devices intended to primarily 
collect sensor readings. Telemetry packets sent 
from this device will be higher priority, 
broadcasting every five minutes. 


Source: https://meshtastic. org/docs/settings/config/device 


Q If you're planning to put your LoRa radio in a high place 
to support the Meshtastic network, select Router & Client. 
Otherwise, leave Client selected. 


LI If you've changed your device role, tap Save. Your device 
will reboot. 


MAKE SURE GPS LOCATION SHARING IS 
TURNED OFF (iOS) 


The screen captures below are from iOS, but the steps are 
the same for Android. 


“1 Open Settings. 


(p) — 


Bluetooth 


1 Tap App Settings. If the option Provide location to 
mesh is selected, deselect it. 


< Settings App Settings @) 3ed8 


PHONE GPS 


€> Accuracy 984 ft 4+ Sats1 


? Coordinates 0.00000, 0.00000 


@ Provide location 
to mesh 


1 /OS only: Go to Settings in iOS, scroll down, and tap 
Meshtastic. Then make sure Location sharing is set to 
Never. 


< Settings | Meshtastic 


ALLOW MESHTASTIC TO ACCESS 


Location Never 


Bluetooth . @ 


x] Siri & Search 


Notifications 


Banners, Sounds, Badges 


Live Activities . @ 


)) Cellular Data 


While you're here, tap on Siri & Search. To avoid leaking 
data needlessly, deselect Learn from this App and Show 
Content in Search. 


< Back Siri & Search 


Learn from this App 
Allow Siri to learn from how you use 


“Meshtastic” to make suggestions across 
apps. 


WHILE SEARCHING 


Show App in Search [ @ 


Show Content in Search 


Allow “Meshtastic” the app and its content to 
appear in Search. 


MAKE SURE GPS LOCATION SHARING IS 
TURNED OFF (ANDROID) 


(J Tap the Settings icon in the top right corner. If "Provide 
location to mesh" is checked, uncheck it. 


//\. Meshtastic 


Your Name 


Iffy Books 


Connected to radio (heltec-v3 2.1.17.7ca2e81) 


O None (disable) 
© Meshtastic_6ddc 


CT Provide location to mesh 


READ MORE ABOUT DEVICE 
CONFIG OPTIONS 
“J Go to the following URL to read more about the config 
options for Meshtastic: 


https://meshtastic.org/docs/settings/config 


SEND A MESSAGE TO THE GROUP CHAT 


LJ Tap the Messages icon. 


(J Then tap the icon for channel 0, which will take you to 
the primary channel (a.k.a. the group chat). 


//\. Meshtastic 
Contacts 


CHANNELS 


@ Primary Channel 


LJ Type a message and tap the Send button. 


LongFast 


Send Text 


Hi there! 


< f) «iF 


Ue 2 
qwer 


PPS Pc bel badh 


<> ze Be ies iva foe ene ina) 


<< 


If your message is received and acknowledged, on Android 
you'll see a check mark appear in the cloud icon under your 
message. In the iOS app you'll see the word "Acknowledged" 
appear under the message. 


Hi there! Hi there! 


17:28 @ 17:37 @ 


> 


SEND A DIRECT MESSAGE 


Once you've connected with someone in the primary 
channel, you can send a direct message (DM). 


(1 Tap the Messages icon. Under Direct Messages, tap the 
device you want to DM. 


/, IAN Contacts 


CHANNELS 


Primary Channel 
Hi there! 


DIRECT MESSAGES 


@ Mattie (6ddc) 


LI Type a message and tap Send. 


Hey! Now we're in a DM thread, @ 


Dismiss Sa Bytes: 31/228 


qwe 


You're texting without the internet or cell network! Pretty 
neat. 


It's important to note that Meshtastic DMs are encrypted 
using the same shared key as the channel marked 
PRIMARY. That means anyone else on the same channel 
can (in theory) read your direct messages. 


If you want to chat privately with a friend, create a new 
shared encryption key, set the channel to PRIMARY, and 
don't reveal it to anyone else. (Details in the next section.) 


CREATE A NEW PRIVATE KEY 


When you first set up Meshtastic, your messages are 
encrypted using a weak default key, which is widely known. 
Many Meshtastic users stick with the default key because 
they aren't concerned with privacy. To chat privately, you'll 
need to generate a new encryption key and share it with the 
person/people you're planning to chat with. 


We recommend against creating and updating encryption 
keys using the iOS and Android apps. We've gotten 
unexpected results during testing, and it isn't worth the 
hassle. 


Instead, we'll generate an encryption key using the 
command line. Then we'll use the Meshtastic Web Client to 
update the settings on your LoRa device. 


(1 Meshtastic uses AES-256 encryption, so you'll need a 
256-bit key in Base64 format. To generate one, opena 
terminal window and run the following command. (To type 
the pipe character, hold shift and press backslash.) 


cat /dev/urandom | head -c 32 | base64 


The command above generates 32 bytes of random 
characters (equivalent to 256 bits), then converts it to the 
Base64 encoding format. The output will look something like 
this: 

dqP9LPdBkE/bF5IisYCwsXfnNavx3!IkISLsUoCu91F/4= 
Highlight your new key in the terminal window, then 


right-click and select Copy. Now you can share the key with 
your friends! 


Note: When distributing your shared encryption key with 
friends, it's best to use an encrypted channel such as Signal. Or 
post the key on CryptPad.fr and share the link via Signal. 


LAUNCH THE MESHTASTIC WEB CLIENT 


The quickest way to update your Meshtastic settings from a 
computer is to use the Meshtastic Web Client. Unfortunately 
you'll need to use a Chromium-based browser, such as 
Google Chrome. If you don't already have it, you can 
download it here: 

https://www.google.com/chrome 


[1 Connect your LoRa device to your computer with a USB-C 
cable that supports data. 


1 Open Chrome and go to the following URL: 


https://client.meshtastic.org 
LJ Click New Connection. 


W! Meshtastic web x + 


€7C¢C a client.meshtastic.org 


a Connected Devices 


Manage, connect and disconnect devices 


+ 


No Devices 


Connect atleast one device to get started 


+ New Connection 


Q) At the top of the Connect New Device window, click the 
Serial tab. 


Connect New Device 


HTTP Bluetooth 


J Click the New device button. 


| Meshtastic web < |e 2 Shi) 


€ > CG @ client.meshtastic.org <* Oa: 


Connect New Device 


HTTP Bluetooth 


No devices paired yet. 


Web Bluetooth and Web Serial are currently only supported by 
Chromium-based browsers. 


Read more: Web Bluetooth Web Serial 


Q) You'll see a prompt that reads "client.meshtastic.org 
wants to connect to a serial port." Scroll through the list and 
look for the USB serial port that corresponds to your LoRa 
device. Click the port to highlight, then click Connect. 


fa \client.meshtastic.org 


client.meshtastic.org wants to connect to a serial port 


ttyS30 


ttys31 


Web Bluetooth and Web Serial are currently only supported by 
Chromium-based browsers. 


Read more: Web Bluetooth Web Serial 


In the example above, the port is called ttyUSBO. 


Q) You'll see a new rectangular button at the top of the 
window. Click on it to connect to your LoRa device. 


WD Meshtasticweb xo+ » -16 


€ > CG @ client meshtastic.org <wv Of: 


Connect New Device 


lead more! Web Bluetooth Web Serial 


J Click X to close the Connect New Device window. 


UPDATE YOUR SHARED ENCRYPTION KEY 


Cd In the Navigation column, click on Channels. 


® Neshtastic web 


@ client.meshtastic.org 


3ed8 


Meshtastic 3ed8 


Navigation 


1 Messages 
Map 

8 Config 
@ Channels 


& Peers 


284502 


Channel: Primary 


Primary ch1 
Channel Settings 
Crypto, MQTT & misc settings 


Role Jescription 


PRIMARY 


pre-Shared Key 


Channel Number 


Let's keep using the default key on the primary channel and 
add a shared key on channel 1. 

LI Click the Ch 1 tab to switch to channel 1. Highlight the 
text in the pre-Shared Key field and delete it, then paste in 
your new shared key. 


@® Meshtastic web 


Cc fa client.meshtastic.org 


3ed8 
Meshtastic 3ed8 
Navigation 
D Messages 
@ Map 


$8 Config 


< Channels 


& Peers 


Channel: Primary 


Primary ch1 


Channel Settings 
Crypto, MQTT & misc settings 


Role Description 


SECONDARY 


pre-Shared Key 


Channel Number 


4 Scroll down and give your channel a name (optional). 
When you're done, click Submit and your device will reboot. 


WB Mesttastic Web 


@ client. meshtastic org 


3ed8 Channek: Primary 
Mashtastic 3ed8 


Description 


Navigation 


shin) 


1 Messages 


00 Map 
Description 


& Config 
1 
Channels 


& Peers 
Uplink Enabled Description 


Downlink Enabled Description 


(1 Go to Messages and you'll see your new channel. 


/, IN Contacts 


CHANNELS 


@ Primary Channel 
@ Shhhh 


DIRECT MESSAGES 


Messages 


SET YOUR PRIVATE CHANNEL TO PRIMARY 


If you want direct messages to be encrypted with your 
private key, you'll need to set your private channel to 
PRIMARY. 


1 Go to Channels in the Meshtastic web app. 


J Set Channel 0 from PRIMARY to SECONDARY. Click 
Submit to save. 


LJ Set Channel 1 from SECONDARY to PRIMARY. Click 
Submit to save. 


INSTALL THE MESHTASTIC CLI 


1 Open a terminal window and run the following 
commands to install the Meshtastic CLI (command-line 
interface). The same commands should work for Linux, 
macOS, and Windows. 
python3 -m pip install --upgrade pytap2 
python3 -m pip install --upgrade meshtastic 


(1 Run the following command to see if the CLI is installed 
properly. You should see a list of options. 


meshtastic --help 


L If the command above doesn't work, you'll need to add the 
meshtastic application file to your PATH environment 
variable. If you're using Linux, you can do that by modifying 
your ~/.profile file. (On macOS it'll be ~/.bash instead.) 


First, find the meshtastic application file. Here's where it's 
located in Linux Mint: 


/home/iffybooks/.local/bin/meshtastic 


Run the following command to open ~/.profile using the 
nano text editor. 


sudo nano ~/.profile 


Create a new line at the end of the file and type the 
following line, swapping in the path to your meshtastic 
application file: 


export PATH="/home/iffybooks/.local/bin:$PATH" 


“I Press ctrl+o to save the file. You'll be prompted to check 
the filename. Press enter. 


LI Close your terminal window and open a new one. 


(1 Run the following command and you should see a list of 
options for the Meshtastic CLI: 


meshtastic --help 


GET A LIST OF MESHTASTIC NODES 


(4 Run the following command to see a list of Meshtastic 
nodes on the network: 


meshtastic --nodes 


SEND A MESSAGE FROM THE 
COMMAND LINE 


[1 Connect your LoRa radio to your computer with a USB 
cable and run the following command to send a message to 
the primary channel: 


meshtastic --sendtext "Hello out there\!" 


SEND A MESSAGE EVERY 10 MINUTES 


Here's a brief shell script you can use to send the same 
message every 10 minutes (600 seconds): 


while : 

do 
meshtastic --sendtext "Hello out there\!" 
Sleep 600 

done 


LEARN MORE ABOUT THE MESHTASTIC 
BROADCAST ALGORITHM 


You can learn more about Meshtastic's broadcast algorithm 
here: 


https://meshtastic.org/docs/overview/mesh-algo 
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